Upgrade the Software

Important

Important

Upgrades from some releases require release-specific steps. For more information, see VOSS Release Notes.

Perform this procedure to upgrade the software on the switch. This procedure shows how to upgrade the software using the internal flash memory as the file storage location.

You can store up to six software releases on the switch. If you have six releases already stored on the switch, you are prompted to remove one release before you can proceed to add and activate a new software release.

For information about how to remove a software release, see Remove a Software Build.

Before you begin

  • To obtain the new software, go to the Extreme Networks Support portal. You need a valid user or site ID and password.

  • Back up the configuration files.

  • Use an FTP or SFTP application or USB device to transfer the file with the new software release to the switch.

  • Ensure that you have not configured a VLAN above 4059. If you have, you must port all configuration on this VLAN to another VLAN, before you begin the upgrade.

    Caution

    Caution

    Only VLAN range 2 to 4059 is supported. All configuration on a higher numbered VLAN from earlier releases will be lost after the upgrade.

Note

Note

Software upgrade configurations are case-sensitive.

Procedure

  1. Enter Global Configuration mode:

    enable

    configure terminal

  2. If you are using the USB port to transfer files, go to the next step. If you are using FTP or SFTP to download the files, start the FTP daemon on the switch and enable the ftpd flag for FTP or sshd flag for SFTP:
    Note

    Note

    Start an FTP session from your computer to the switch using the same user name and password used to Telnet or SSH to the switch. Upload or copy the image to the switch.

    boot config flag <ftpd | sshd>

    end

  3. Download the files to the switch through FTP or SFTP, or transfer them to the switch through the USB port.
  4. Enter Privileged EXEC configuration mode by exiting the Global Configuration mode.

    exit

  5. Extract the release distribution files to the /intflash/release/ directory:

    software add WORD<1-99>

    After you enter this command, the switch verifies it has sufficient space to install the new image. If space is not insufficient, the switch checks the total space of the log files. If the total log file space is sufficient for the new image, the switch prompts you to remove log files.

  6. Optional: Respond if you see the following prompt:

    Log files need to be removed to have enough space to install the new image.

    Do you want to remove all log files except the current one?

    If your response is affirmative, the switch removes all log files except the currently active file and displays the following message for each file removed: Log file %s was removed

  7. Install the image:

    software activate WORD<1-99>

  8. Restart the switch:

    reset

    Important

    Important

    After you restart the system, you have the amount of time configured for the commit timer to verify the upgrade and commit the software to gold. If you do not commit the software to gold and auto-commit is not enabled, the system restarts with the last known working version after the commit timer has expired. This feature ensures you can regain control of the system if an upgrade fails. By default, auto-commit is enabled.

  9. After you restart the switch, enter Privileged EXEC configuration mode:

    enable

  10. Confirm the software is upgraded:

    show software

  11. Commit the software:

    software commit

    Important

    Important

    If you disable the auto-commit feature, you must run the software commit command manually before the commit timer expires to commit the new software version, otherwise the system restarts automatically to the previous (committed) version. By default, auto-commit is enabled.

Example

Note

Note

The image file name is switch dependent. See VOSS Release Notes for information about file names.

Switch:1>enable
Switch:1#configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
Switch:1(config)#boot config flags ftpd
Switch:1#end
Switch:1#copy /usb/VOSS4900.9.0.0.0.tgz /intflash/VOSS4900.9.0.0.0.tgz
Switch:1#software add VOSS4900.9.0.0.0.tgz
Switch:1#software activate VOSS4900.9.0.0.0.GA
Switch:1#reset -y
Switch:1#show software
================================================================================
                    software releases in /intflash/release/
================================================================================
8.8.0.0.GA                 (Backup Release)             (Signed Release)
9.0.0.0.GA                 (Primary Release)            (Signed Release)

--------------------------------------------------------------------------------
Auto Commit     : enabled
Commit Timeout  : 10 minutes

Remaining time until software auto-commit is 8 minutes 59 seconds

Switch:1#show software detail
================================================================================
                    software releases in /intflash/release/
================================================================================
9.0.0.0.GA              (Primary Release) (Signed Release)
    KERNEL                           5.4
    ROOTFS                           5.4
    APP_FS                           9.0.0.0.GA
  AVAILABLE ENCRYPTION MODULES
    No Modules Added

8.8.0.0.GA               (Backup Release) (Signed Release)
    KERNEL                           5.4
    ROOTFS                           5.4
    APP_FS                           VOSS4900.8.8.0.0
  AVAILABLE ENCRYPTION MODULES
    No Modules Added
----------------------------------------------------------------------------------
Auto Commit     : enabled
Commit Timeout  : 10 minutes

Remaining time until software auto-commit is 8 minutes 41 seconds

Switch:1#software commit
Executing software commit for version VOSS4900.9.0.0.0.GA.
Software commit successful
  

Variable Definitions

The following table defines parameters for the software command.

Variable Value
activate WORD<1-99>

Copies the software version to the boot flash file.

When you use the software activate command, the system checks for hardware dependencies and prevents a downgrade if it detects a dependency. For example, if a hardware component has a minimum software version dependency, you cannot downgrade to an incompatible software version or install the hardware component in a chassis that runs an incompatible software version.

add WORD<1-99>

Unpacks a software release <version>.

After you enter this command, the switch verifies it has sufficient space to install the new image. If space is not insufficient, the switch checks the total space of the log files. If the total log file space is sufficient for the new image, the switch prompts you to remove all log files except the currently active file. If your response is affirmative, the switch displays the following message for each file removed: Log file %s was removed